home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 1 / Meeting Pearls Vol 1 (1994).iso / amok98-106 / amok101 / interfaces / interfaces3_4.lha / ReadMe < prev    next >
Text File  |  1994-04-16  |  8KB  |  242 lines
  1.                                                           16 Apr 1994
  2.  
  3.           AmigaOberon System Interfaces 40.15 Oberon 3.4
  4.           ==============================================
  5.  
  6.    © Copyright 1992-1994 by Fridtjof Siebert und hartmut Goebel
  7.  
  8.  
  9. This archive holds the AmigaOberon Interfaces for AmigaOS 3.1 (V40),
  10. based on includes V40.15, Oberon Version 3.3.
  11.  
  12. NOTE: The numbering scheme has been changed to reflect the original
  13.       include version and the Oberon version has been added.
  14.       So Interfaces 40.15 Oberon 3.3 are the successors of the
  15.       previously released Interfaces 40.17.
  16.  
  17.  
  18. Copyright
  19. =========
  20.  
  21.   This interfaces are
  22.  
  23.      © Copyright 1992-1994 by Fridtjof Siebert und hartmut Goebel
  24.  
  25.   The complete and unchanged archive may be freely distributed for
  26.   use with AmigaObern only. Please consult the AmigaOberon manual
  27.   for detailed licence.
  28.  
  29. Warranty
  30. ========
  31.  
  32. I've done my best to remove all recently knows bugs (but please check
  33. with the bugs file, if supplied) and convert the includes as good as
  34. possible. But remember:
  35.  
  36.    * No Warranty
  37.  
  38.      THE MODULES AND PROGRAMS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF
  39.      ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED
  40.      TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  41.      PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE RESULTS AND
  42.      PERFORMANCE OF ANY MODULE IS ASSUMED BY YOU.
  43.  
  44. When you find any bugs, please mail them to:
  45.  
  46.   interface-bugs@oberon.nbg.sub.org
  47.  
  48. Your report will then be added to the bugs database automatically
  49. and you'll get a reciept notification. PLEASE use this service to
  50. make sure every report reaches me! I may miss reports posted to news
  51. groups (I read only very few of them).
  52.  
  53.  
  54. Installation
  55. ============
  56.  
  57. ATTENTION: Please use 'recomp3_10.lst' for AmigaOberon V3.10/3.11 (and
  58.            probably higher) since there have been some changes in the
  59.            module compilation order.
  60.  
  61. NOTE: Due the introduction of Exec.LSTRPTR (see below) you have to
  62.       change two standard modules which come with AO 3.0+: io.mod and
  63.       Display.mod.
  64.       In io.mod simply exchange the one occurance of STRPTR into
  65.       LSTRPTR. In Display.mod you MUST NOT change the type, since
  66.       this would lead to big trouble (see below, too). Instead change
  67.       the tree assignments like    nw.title := win.title;
  68.       into                         nw.title := sys.ADR(win.title^);
  69.  
  70.  
  71. For re-compiling all modules procede as follows:
  72.  
  73.   assign om: Oberon:Module      ;or wherever they are
  74.   assign oa: Oberon:Interfaces  ;    - " -
  75.   cd Oberon:                    ;or wherever you module's sym/ and obj/ dirs are
  76.   lha x Interface38,108 *.mod oa:/
  77.   Oberon <recomp.lst        ; or recomp3_10.lst'
  78.   Oberon -a <recomp.lst     ; or recomp3_10.lst'
  79.   Oberon -md <recomp.lst    ; or recomp3_10.lst'
  80.   Oberon -mad <recomp.lst   ; or recomp3_10.lst'
  81.  
  82.  
  83. Release Notes
  84. =============
  85.  
  86. *** 40.15/3.4 ***
  87.  
  88.   · Graphics.Layer fields are now read-only ([Libs3] p.704)
  89.   · Narrator.Mouth.shape is now read-only
  90.   · new type Utility.AsmHookFunc for easier casting
  91.   · Exec.SINGLE changed from LONGREAL to LONGSET to avoid intermix,
  92.     constants in MathIEEESingBas.mod are now casted to Exec.SINGLE
  93.  
  94. *** 40.15/3.3 ***
  95.  
  96.   · optimized Graphics.SaveSetWriteMask() (register parameters)
  97.   · Utility.HookEntry() returns Exec.APTR;
  98.   · Intuition.BuildEasyRequestArgs() passed arg1 in wrong register
  99.   · Dos.SetMode() returns BOOLEAN (according to autodocs)
  100.  
  101. *** 40.15/3.2 *** (was 40.17)
  102.  
  103.   · Bad, bad: Exec.mod had had no module body if compiled for
  104.     AmigaOberon 3.10+. Fixed.
  105.   · Dos.CSource.buffer is now Exec.LSTRPTR, too.
  106.  
  107. *** 40.15/3.1 *** (was 40.16)
  108.  
  109.   · Commodities: PFT renamed to PFL
  110.   · Dos.Fault() now returns LONGINT
  111.   · IFFParse: errMamgled renamed to errMangled
  112.   · Printer: Bugs in PrinterData and DeviceData removed
  113.   · Workbench.WBArguments is now
  114.       ARRAY MAX(LONGINT) DIV Size(WBArg) -1 OF WBArg;
  115.  
  116. *** 40.15/3.0 *** (was 40.15)
  117.  
  118.   · all (* char) are now Exec.LSTRPTR !!!
  119.     BEWARE: do not allocate a pointer of this type, since this will
  120.             try allocate 2GB of memory
  121.             do not dereference exept for VAR parameters and for
  122.             procedures where $CopyArray- is set.
  123.     See note above for changes in standard modules.
  124.   · to improve date/type savety a lot of record/struct
  125.     fields are marked as read-only or are not longer exported. E.g.
  126.     in modules ASL, ConUnit, Config, Datatypes, DiskFont, Dos, Exec,
  127.     Graphics, RealTime, ...
  128.   · checked all imports wether they are marked if used in interface
  129.     (e.G. SYSTEM)
  130.   · includes Albert Weinerts 'Classface' package (originally named
  131.     'Boopsi')
  132.   · includes Martin Honeffers 'RVI' package (for rexxvars)
  133.   · all modules terminate with HALT(20) now if OpenLib() fails
  134.   · a lot of small procedures now got register parameters for better
  135.     code
  136.  
  137.   Dos
  138.   · new type DeviceListAPtr, DevInfoAPtr, DosListAPtr
  139.  
  140.   Exec
  141.   · bug with StackSwap() removed
  142.   · new tpye LSTRPTR
  143.  
  144.   Commodities.mod
  145.   · bug removed with constants duplicate, notify, unique
  146.   · removed CxFilter (obsolete)
  147.  
  148.   GadTools
  149.   · new constant value: 'noList' for short list locking (see RKMs)
  150.  
  151.   Gadgets
  152.   · new Proc: CloseColorWheel()
  153.  
  154.   Graphics
  155.   · new PROCEDURE GetOPen synonym for consistency with
  156.     SettOutlinePen/SetOPen
  157.  
  158.   InputEvent
  159.   · InputEvent is now only a dummy base type
  160.  
  161.   Intuition
  162.   · OpGet.storage is now pointer to Exec.ADDRESS
  163.   · bug removed: SetScreenposition()-Flags
  164.  
  165.   Utility
  166.   · new type HookFunc
  167.   · new PROCEDURE GetTagDataP(A) --- nachsehen
  168.   · introduced TagListPtr (more security and comfort)
  169.   · removed bug in SMult32 UMult32
  170.  
  171.   Workbench
  172.   ·  Type WBArguments is now ARRAY MAX(INTEGER) OF WBArg (was ARRAY 256)
  173.  
  174. *** 40.5 ***
  175.  
  176.   Added interfaces
  177.   · CDDevice.mod (original name is devices/cd.h but CD.mod would be to short)
  178.   · LowLevel.mod
  179.   · NonVolatile.mod
  180.   · RealTime.mod
  181.  
  182.   Renamed DataTypes.mod to Datatypes.mod (was tippo)
  183.  
  184.   Removed interface DTClass.mod:
  185.     this is was originaly a prototype for DTClass and is not usable
  186.     in Oberon this way.
  187.  
  188.  
  189. *** 39.108 ***
  190.  
  191.   · all names of libs, devices etc. are now exported constants
  192.   · removed some tippos
  193.   · optical clean up
  194.  
  195.   Dos
  196.   · intoduced type 'ArgsStruct' and some additional types to improve
  197.     type savety for ReadArg().
  198.   · ReadArgs() now want's this type as parameter, OldReadArgs() still
  199.     has old parameters.
  200.  
  201.   Exec
  202.   · new type LONGBOOL and consts LTRUE, LFALSE since used in
  203.     different interfaces
  204.   · RawDoFmt() now returns e.APTR, OldRawDoFmt returns nothing
  205.  
  206.   Intuition
  207.   · some u.TagItemPtrs are now u.TagListPtrs for easier handling
  208.     (e.g. in boopsi messages).
  209.   · MakeScreen, RemakeDisplay and RethinkDisplay now return LONGINT;
  210.     Oldxxx still return nothing
  211.   · OldActivatedWinodw() removed (unnecesary).
  212.  
  213.   Locale
  214.   · constant identifiers now start with lower case charakters
  215.   · clean up
  216.  
  217.   Utility
  218.   · new type 'TagListPtr' to improve handling of Taglists
  219.   · some functions return TagListPtr instead of e.ADDRESS;
  220.  
  221.   Added interfaces
  222.     AmigaGuide.mod (supplied by Lars Düning)
  223.     Bullet.mod
  224.     CardRes.mod
  225.     DTClass.mod
  226.     DataTypes.mod
  227.     Gadgets.mod
  228.     Prefs.mod
  229.     Sana2.mod (supplied by Nicolas Benezan [bene])
  230.  
  231. Litaruture:
  232.  
  233. [Libs3] RKM Libraries, 3rd Edition
  234. [Devs3] RKM Devices, 3rd Edition
  235.  
  236. Enjoy it!
  237. +++hartmut
  238.  
  239. | Hartmut Goebel | UseNet: hartmut@oberon.nbg.sub.org     // Only Amiga |
  240. | Amiga Software | Fido:2:246/81.1  IRC: Essich        \\X/ Oberon  ZOC |
  241. | Manufactur     |            PGP key available                         |
  242.